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3 Mapping value V to parameter ¢ 


Liebmann software uses PPM graphic file format, which has been described in 
Wikipedia [1] (package Netpbm). 

We want to transform value of parameter V to colour value (3 pixel compo- 
nents: red/green/blue). 

Parameter V can be potential of electric field, but it can be other value, such 
as electric force EF. 

Some Liebmann colour mapping recipies (Hot-To-Cold and Jet) work with 
paramter ¢, which has values in range [—1.0,...,+1.0], whereas the value of 
parameter V lies in range [Vinin, ---; Vmax] (they must be determined before 
mapping, beause we want to know the range of V). 

That's why the value of V must be ,, normalized” - transformed from range 
[—Vinins ---> Vmax] to range [—1.0, ..., +1.0] 

The transformation is done by linenar function shown below. 


tv) A 
+1.0 + white 
-1.0 a black colormap 
return -1 return 0 | return +1 
| | - 
Vinin Vinax 


Figure 1: Mapping value V to parameter t 


It 


is also worth to say about return value. If value of parameter V lies in 


range [Vinin; ---; Vmax], then value 0 is returned (interpolation done properly). In 


other 


cases return value is -1 (V < Vin) or +1 (V > Vina). 


Summary: 


1. 
2. 


3. 


if V < Vin then colour is black and return -1 


if Vain < V < Vmin then we use colormap to determine colour and 
return 0 


if V > Vmax then colour is white and return +1 


For ,inverted” colour mapping (reversed), transformation is done by function 


below. 
tv) A 
41.0 wat se white 
-1.0 ahs, colormap black 
return +1 return 0 | return -1 

| | 
i 
Vin Vaz 


Figure 2: Inverted mapping value V to parameter t 


In this case the return value is also ,inverted”. 
Summary for inversed colour mapping: 


1. 
2. 


if V < Vin then colour is white and return +1 


if Vinin < V < Vmax then we use colormap to determine colour and 
return 0 


. if V > Vinax then colour is black and return -1 


7 4 clamp function 


ze Some Liebmann colour mapping uses also function clamp , which was found 
7s on Stackoverflow forum [2]. 


0 ifa<0 
clampp1j(t) = 4x ifO0<a2<1 (4.1) 
1 ife@>1 
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5 Grayscale colormap 


This colour mapping does not use parameter ¢ and clamp function. 
We have parameter V such that: Vinin < V < Vinaz- 
In our grayscale colormap any shade of grey has all the 3 parameters r/g/b 
the same. 
V- Vinin 
=g=b= —_ 5.1 
. Z Vinax = Vnin ( ) 
All the r/g/b have values in range [+0.0,..., +1.0]. For PPM (P3) graphic 
file format these r/g/b values should be multiplied by maximal unsigned char 
value (255). Liebmann software uses Netobm PPM P3 file format with unsigned 
char values (0,1,2, .., 255). 
For inverted grayscale colour mapping we use different formula: 
Vinax : V 
=g=b= — 5.2 
C 4 Vinax = Vinin ( ) 
And also all the r/g/b have values in range |+0.0, ...,+1.0]. For PPM (P3) 
graphic file format these r/g/b values should be multiplied by maximal unsigned 
char value (255). Liebmann software uses Netpbm PPM P39 file format with 
unsigned char values (0,1,2, .., 255). 
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6 Hot-to-cold colormap 


This colour mapping was also found on Stackoverflow forum [2]. 

This colour mapping uses parameter t and clamp function. 

If we dertermine value of parameter t, we can map its value to 3 values of 
pixel colour (red/green/blue). 


r(t) = clampyg,1)(2 — |2¢ — 2]) 


g(t) = clampyo,1(2 — |2¢]) (6.1) 


—10<7< 410 (6.2) 


t/g/b have values in range [+0.0, ..., +1.0]. For PPM (P3) graphic file format 
these r/g/b values should be multiplied by maximal unsigned char value (255). 

Liebmann software uses Netpbm PPM P3 file format with unsigned char 
values (0,1,2, .., 255). 


7 Jet colormap 


This colour mapping was also found on Stackoverflow forum [2]. 

This colour mapping uses parameter t and clamp function. 

If we dertermine value of parameter ¢, we can map its value to 3 values of 
pixel colour (red/green/blue). 


r(t) = clampyo1)(1.5 — |2¢ — 1)) 
g(t) = clampyo1j (1.5 — |2¢]) (7.1) 
b(t) = clampjg1)(1.5 — |2¢ + 1)) 


1024< 410 (7.2) 


t/g/b have values in range [+0.0, ..., +1.0]. For PPM (P3) graphic file format 
these r/g/b values should be multiplied by maximal unsigned char value (255). 

Liebmann software uses Netpbm PPM P3 file format with unsigned char 
values (0,1,2, .., 255). 
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